SYSTEM COMMANDS 



Notes: (i) Items in brackets are optional, (ii) WSID: library number and workspace name or workspace name 
alone, as required, (ill) See Table 5 for Trouble Report. 



FUNCTION 

Terminal Control Commands 

Sign-on designated user and start work session. 
End a work session. 

End work session and hold dial-up connection. 
End work session and store active workspace. 

End work session, store active workspace, and 
hold dial-up connection. 



COMMAND 



)123846 
)OFF 

)OFF HOLD 
) CONTINUE 

) CONTINUE HOLD 



PASSWORD] 
NEWPASSWORD] 
NEWPASSWORD] 
NEWPASSWORD] 

:NEWPASSWORD] 



RESPONSE 



Port, time, date, user; system; time, date 
Port, time, date, user code; time used 
Port, time, date, user code; time used 
Time, date. 

Port, time, date, user code; time used 
Time, date. 

Port, time, date, user code; time used 



TROUBLE REPORTS 



1 2 3 4 5 7 

15 

16 

6 1b 



Communication Commands 



Send message to designated port. 
Send message to designated port and 

lock keyboard for reply. 
Send message toAPL Operator. 
Send message to APL Operator and lock 

keyboard for reply. 



)MSGN 
)MSC 



)OPRN 
)OPR 



PORT (TEXT) 
PORT (TEXT) 

(TEXT) 
(TEXT) 



SENT 
SENT 



SENT 
SENT 



15 15 
15 16 



15 16 
15 15 



Workspace Control Commands 



Activate a clear workspace. ) CLEAR 

Replace active workspace with a copy of ) LOAD 

a stored WS. 

Copy an individual function or variable ) COPY 

from a stored WS. 

Copy all functions and variables from a )COPY 

stored workspace. 

Copy an individual function or variable from ) PCOPi 

a stored WS protecting the active workspace. 

Copy all functions and variables from a stored )PCOPY 

workspace protecting the active workspace. 

Gather functions and variables into a group; ) GROUP 

first name is name of group. 

Erase functions and variables. ) ERASE 

Set index origin. ) ORIGIN 

Set maximum number of significant ) DIGITS 

digits for output. 

Set size of symbol table in clear workspace. ) SYMBOLS 

Set maximum width for an output line. ) WIDTH 

Change Workspace name. ) f/SID 

Re-store a copy of the active workspace. ) SA VE 

Store a copy of the active workspace. ) SA VE 

Erase a stored workspace from a library. )DROP 



WSID 

WSID NAME 

WSID 

WSID NAME 

WSID 

NAME(S) 

NAME(S) 
Oor 1 
1 to 16 

Positive integer (min. 26) 

30 to 130 

Name 

WSID 
WSID 



CLEAR WS 

SA VED , 

SAVED, 

SA VED , 

SA VED , 

NONE 

[NOT ERASED, 

WAS, 

WAS , 

WAS , 
WAS, 
WAS, 

WAS , 

WAS, 



Time, Date 

Time, Date 
Time, Date 
Time, Date 
Time, Date 



List of names ] 
Former origin 
Former maximum 

Former size 
Former width 
Former WSID 
Time, date, WSID 
Time, date 
Time, date 



16 
7 

6 

5 

6 

5 



8 16 

7 8 9 10 16 

10 15 

9 10 16 

10 15 



10 11 16 

10 16 

16 

16 

15 
16 
16 
6 12 13 lU 16 

6 12 13 14 16 

7 lU 16 



Information Requests 



List names of defined functions. )FNS 

List names of global variables. ) VARS 

List names of groups. ) GRPS 

List membership of designated group. )GRP NAME 

List halted functions (state indicator). )SI 

List halted functions and associated )SIV 

local variables. 

Give identification of Active workspace. ) wsiD 

List name of workspaces in designated library )LIB [NUMBER] 

(either user's library or a public library). 

List ports in use and codes of connected users. ) PORTS 

List port numbers associated with designated )PORT CODE 

user code. 



Function names 

Variable names 

Group names 

Function names, variable names 

Sequence of halted functions 

Sequence of halted function 

with names of local variables 
WSID 
Names of stored workspaces 

Port numbers and associated 

user codes 
Port numbers 



16 

le 

16 
16 

16 
16 

16 

14 16 

16 



TABLE 5 



1 NUMBER NOT IN SYSTEM 

2 INCORRECT SIGN-ON 

3 ALREADY SIGNED-ON 

4 NUMBER IN USE 

5 NUMBER LOCKED OUT 

6 NOT WITH OPEN DEFINITION 



7 WS NOT FOUND 

8 WS LOCKED 

9 OBJECT NOT FOUND 

10 WS FULL 

11 NOT GROUPED, NAME IN USB 



12 NOT SAVED, QUOTA USED UP 

13 NOT SAVED, THIS WS IS ... 

14 IMPROPER LIBRARY REFERENCE 

15 MESSAGE LOST 

16 INCORRECT COMMAND 
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Keyboard for 2741 Terminal 
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APL REFERENCE DATA 

Scalar Dyadic Functions 

Xfi XplusY 

X-Y X minus Y 

;fxy X times Y 

Xiy X divided bvY 

X*I X to the Y-th power 

X[ Y maximum of X and Y 

XII minimum of X and Y 

X I i X-residue of Y (see Table 4) 

X»Y base-X logarithm of Y 

X '. 1 binomial coefficient; for integer X 

and Y, the number of combinations 

of Y things taken X at a time 
XoY circular and hyperbolic functions 

and their inverses (Y is in radians) 

(see Table 1) 
X<'l X less than Y 
X<.1 X less than or equal to Y 
X=y X equal to Y 
Xsy X greater than or equal to Y 
X>Y X greater than Y 
X*l X not equal to Y 
Xi-1 XandY 
ATvy XorY 

X*<1 not both X and Y (X nand Y) 
AT^y neither X nor Y 



Ooy (1-Y»2)».5 noy (1+Y«2)*.5 

loy sin Y 5oy sinh Y 

2oy COS Y 6oy cosh Y 

3oy tan Y 7oy tanh Y 

inverse functions are given by negative 
values of X, i.e. ~loy = arcsin Y. 

Table 1 



Scalar Monadic Functions 

+ y Y 
-y o-Y 

xy signof Y(-1, 0, 1) 
T y reciprocal of Y 
* y e to the Y-th power 

[ySfV } (See Table 3, 
I y magnitude of Y 
»y natural logarithm of Y 
! y factorial Y; Gamma 
function of Y + 1 

oy IT times Y 

?y a random integer from the 

vector 1 Y 
~y not Y 



" result is 1 if the relation holds, 
if it does not 



X 


y 


X^Y 


jrvy 


Xfl 


Jfvy 














1 


1 





1 
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1 





1 








1 
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1 


1 


1 









Table 2 



y 


ry 


Ly 


a.iH 
"s.iu 


4 

"3 


3 
"4 



Table 3 



Jf=0 



ATiy 



Table 4 



X^VIiX 



Special Symbols 

( ) Parentheses. Expressions may be of any complexity and arc executed from 
right to left except as indicated by parentheses. 

■*X Branch to X, where X is a scalar or vector. If X is an empty vector, go to 
the next line in sequence. If X is not in the range of statement numbers in 
the function, leave the function. 

->■ Terminate execution of a suspended function. 

Z\*-X Print the value of X. The value of any expression or variable is also printed 
if no assignment is made. 

.?-*-D Request input. Value of D is the resulting value after expression entered is 
evaluated. 

X-^'& Request input. Value of H is entire input text as literal characters, up to but 
not including carrier return. 

'/rZ'The literal characters XYZ. 

Underline: Allows increased set of alphabetic characters, i.e., A and A are 
both distinct characters. 



Printed in U.S.A. S210-OOO7-0 



Mixed Functions 



XqY 

py 
x[y] 

X\'i ' 
ly 

X(.Y 

x-^Y 

Xi.Y 
X?Y 

X'SfY 

wczjy 
/ey 

<)>y 

(fczjy 
ey 
xw 
siy 

X,i 

,y 
;ri-y 

;if+y 
x<-y 

IX ■ 



Reshape Y to have dimension X 

Dimension of Y 

The elements of X at locations Y 

First location of Y within vector X ' 

The first Y consecutive integers from Origin (0 or 1 as 
set by set origin command) 

Each element of X e Y is 1 or if the corresponding 
element of X is or is not some element of Y / 

Representation of Y in number system X 

Value of the representation Y in number system X 

X integers selected randomly without repetition from lY 

Rotation by X along the last dimension of Y 

Rotation by X along the Zth dimension of Y 

Rotation by X along the first dimension of Y 

Reversal along the last dimension of Y 

Reversal along the Zth dimension of Y 

Reversal along the first dimension of Y 

Transpose by X of the coordinates of Y 

Ordinary transpose of Y 

Y catenated to X 

Ravel of Y ( make Y a vector) 
j If X positive take first X elements of Y 
I If X negative take last | X elements of Y 
I If X positive leave first X elements of Y 
(If X negative leave last IX elements of Y 

X specified by Y 

The indices of values of the vector X in sorted ascending 

order 

The indices of values of the vector X in sorted descending 

order 

Null 

See Program Definition Section 

Comment 



In the entries below 
operator" 

Generalized Reduction 

i.e., insert the symbol 
of Y 



o stands for "any scalar dyadic 



e between each pair of elements 



o/y 

o/[z]y 

o;'y 



;if/y 
x/iz:iY 

XiY 
X\Y 

;ir\[z]y 
x\y 



The o reduction along the last dimension of Y 
The o reduction along the Zth dimension of Y 
The o reduction along the first dimension of Y 

Compression and Expansion 

X (logical) compressing along the last dimension of Y 
X (logical) compressing along the Zth dimension of Y 
X (logical) compressing along the first dimension of Y 
X (logical) expanding along the last dimension of Y 
X (logical) expanding along the Zth dimension of Y 
X (logical) expanding along the first dimension of Y 



Generalized Matrix Operations 

Aft . xy Ordinary matrix product of X and Y 
Xo . oy Generalized inner product of X and Y 
.Y» . oy Generalized outer product of X and Y 

All scalar functions are extended to operate element-by-element on 
dimensioned operands; i.e., vectors, matrixes, and higher-dimensional 
arrays. 

A scalar or one-component vector may be used as one argument of a 
scalar dyadic function and will be extended to conform to the dimen- 
sion of the other argument. 



Overstruck Symbols 

ABCDEFGS.l!LliLM 
NOPQHSTUVWXYZ 



Definition Mode 

A V (called 'Del') preceding a function name declares a change from 
execution mode to function definition mode. In definition mode, no 
execution of commands occurs, and no errors other than character 
errors, editing errors, and label errors are reported. Instead, each com- 
mand is stored as part of the definition. A V terminates function defini- 
tion. 



[1] 

5 

CIJ 
■♦.5 

[1] 

[1] 



19 



yX-^Q HYP P 
rt-(((}*2)+P*2)*0.5V 
3 HYP 1 

VZ-AVG Y 
Z*(. + /Y)tc,YW 

AVG 2 ^ 9 3 

yZ-^RAH 
Z*.'Sp25V 

RAN 
12 14 6 

V4 HYP B 

2'*<(jl*2)+fl*2)*0. 5V 
3 HYP 4 
T 



VAVa N;A 
[IJ A*(.*/N)ipS 
[2 J 'AVERAGE IS: 

AVa 2 H 9 3 
AVERAGE IS: f.5 



;i4V 



CI] 
C2J 
C33 



VDRILL 

•DO THESE PROBLEMS' 
I I 

"... 'V 

DRILL 



dyadic function with explicit 
result 



monadic function with explicit 
result 



niladic function with explicit 
result 



dyadic function without 
explicit result 



monadic function without 
explicit result; a local variable A 
is defined in the header 



niladic function without 
explicit result 



£10 THESE PROBLEMS 



A function body may be displayed in definition mode: 

[iVO] Display line N: if N is omitted, display entire function. Mode 
may be entered, function F displayed, and mode left, by 
typing 7F[D]v. 

COJV] Display from nne N to the end of the function. 

[JVDP] Display line N and position the printing element under posi- 
tion P (for editing line N). 

Trace and Stop Controls 

S&PROG-i-N Halts execution of PROG immediately before line N is 
executed. 

TLPROG-i-ll Displays result of calculation performed in line N of func- 
tion PROG. 

N may be a vector. Trace and Stop controls may be removed by 

A^-t-0 or 1 . 



IBM 



International Business Machines Corporation 
Data Processing Division 

112 East Post Road, White Plains, New York 10601 
(USA only) 

IBM World Trade Corporation 

821 United Nations Plaza, New York, New York 10017 

(International) 



